home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / Dwarf / dwarf4.txt < prev    next >
Text File  |  1996-11-11  |  3KB  |  64 lines
  1.  
  2. DWARF(4)                                                              DWARF(4)
  3.  
  4. NAME
  5.      dwarf - dwarf version 2 debugging information format
  6.  
  7. SYNOPSIS
  8.      #include <dwarf.h>
  9.  
  10. DESCRIPTION
  11.      DWARF is a format for the information generated by compilers, assemblers,
  12.      and linkage editors that is necessary for source-level debugging.  It
  13.      allows a compact representation of programs in many languages and is
  14.      easily extended to handle additional languages and individual
  15.      compiler/debugger requirements.  Consumers reading DWARF information they
  16.      do not understand are able to easily skip past that information, meaning
  17.      that older consumers are not broken by the addition of new features.
  18.  
  19.      DWARF itself does not specify how to generate or use the information.
  20.      Instead, it defines the 'bits on the disc'.  See the libdwarf(4) man page
  21.      for information on reading and writing DWARF information.
  22.  
  23.      This format was designed by a multi-company committee called the PLSIG
  24.      working under the auspices of Unix International.  The format is based on
  25.      the SVR4 debugging information format, (which might be called version 0)
  26.      and a codification of that format developed by the committee (which was
  27.      called version 1).  Version 2 was designed by the committee to reduce the
  28.      disk space used and to add descriptive power (as compared to versions 0
  29.      and 1).  The Version 2.0.0 Industry Review Draft was made available July,
  30.      1993.  The document provided below is that Draft.
  31.  
  32.      For details of the format see the document DWARF Debugging Information
  33.      Format, which is the file dwarf.v2.mm in the IDO/dev option subsystem
  34.      compiler_dev.opt.dwarf.  The file index.v2.mm is an index to that
  35.      document.  The .ps files are PostScript versions of the same files.
  36.  
  37.      The DWARF debugging information is present only in programs compiled -n32
  38.      or -64.  This information is put, as needed, into sections of an ELF
  39.      object file named .debug_info, .debug_frame, .debug_line, .debug_aranges,
  40.      .debug_loc, .debug_frame, .debug_str, .debug_abbrev, .debug_pubnames,
  41.      .debug_weaknames, .debug_funcnames, .debug_typenames, and
  42.      .debug_varnames.
  43.  
  44.      With programs compiled -32, the compiler puts debugging information into
  45.      the .mdebug section of the ELF file (the section format is identical to
  46.      the IRIX 4 COFF symbol table, so the .mdebug section is sometimes
  47.      referred to as 'the symbol table', though this is incorrect terminology
  48.      now).
  49.  
  50. FILES
  51.      /usr/share/src/compiler/dwarf/dwarf.v2.mm
  52.      /usr/share/src/compiler/dwarf/dwarf.v2.ps
  53.      /usr/share/src/compiler/dwarf/index.v2.mm
  54.      /usr/share/src/compiler/dwarf/index.v2.ps
  55.  
  56.                                                                         Page 1
  57.  
  58. DWARF(4)                                                              DWARF(4)
  59.  
  60. SEE ALSO
  61.      libdwarf(4) dwarfdump(1)
  62.  
  63.                                                                         Page 2
  64.